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ee9 Release History 


Releases 

V0.1,04-NOV-2010: First alpha release 

Y0.2,24-NOV-2010: Second alpha release 

a. I advanced the version number to 0.2. 

b. I fixed an inconsistency, between fast mode and other diagnostic modes, in the measurement of the KDF9 virtual 
CPU time consumed when running a program. 

c. I improved the declarations of some of the fundamental types in KDF9 . ads. 

d. I provided a fail-safe way of dealing with programs that corrupt their E0U, so avoiding difficulties for postmortem 
diagnostic printing in U format. 

e. I fixed a bug in the reconstruction of normalised floating-point results from separate fraction and exponent parts. 

f. I added a facility to supply multiple ‘rolls of tape 7 to a tape reader. 

V0.3b, 20-Jan-2011: Third alpha release 

a. I advanced the version number to 0.3, and the copyright date to 2011. 

b. I added a facility to provide a pre-prepared set of replies to console Flexowriter prompts, with the facility to make 
conditional responses. (This nods at the edge-punched card reader of the console Flexowriter.) An audible warning is 
given (i.e., BEL characters are output) when manual Flexowriter input from the user is needed. 

c. I enhanced the setting-file feature to provide separate settings for a first program (e.g., the Whetstone Translator) and 
overlay (e.g., the Controller). 

d. I much reduced ee9’s verbosity by omitting most confirmatory messages, and added the option to suppress even the 
output of the final KDF9 state. 

e. I fixed the timing of I/O transfers that are on-going at the end of a run, and of I/O transfers that are held up by store or 
buffer lockouts. 

f. I fixed a major bug that was detected by Brian Wichmann in the ‘xD’ order. 

g. I fixed the implementation of ‘-D’, which was adding the top 48 bits of its operands instead of subtracting them. This 
had gone quite unnoticed until I called it as a subroutine in the new implementation of ‘xD’! 

h. I fixed the usage-error message from ee9, given in response to incorrect flag parameters. 

i. I decoupled the generation of digital signatures from the running trace mode, thus making signature generation a more 
practical means of verifying correct operation by an ee9 port or new version. 

j. I unified the conditions under which retrospective tracing, digital signature generation, and running trace output, are 
all activated. 

k. I improved the shell commands in Testing, to make running ee9 easier, less error prone, and better diagnosed in 
the case of an error. 

l. 1 provided a HOWTO file that gives more complete instruction on the operating procedures to be followed for 
compiling and running KDF9 programs. 

m. I implemented a first cut at an automatic self-testing process to check the correct operation of an installation or new 
port of ee9. 

n. I simplified the handling of the diagnostic mode options, both internally and vis-a-vis the user-interface semantics; the 
latter now make some sense. 

o. For revision 0.3b I improved the installation and self-testing code, in line with feedback from David Holdsworth. 
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Y0.4,15-FEB-2011: FOURTH ALPHA RELEASE 

a. I advanced the version number to 0.4, and added a message to identify the version of ee9 that is being used. 

b. I improved the encapsulation of the 10 package, by making 10. stream a private type. 

c. I made 10. stream a tagged type, allowing prefix notation, so that component access could be re-interpreted as a 
call on a ‘getter’ function. 

d. I tidied up the diagnostic-mode confirmation message. 

e. I forced runtime checks in all modules, except some in the kdf 9 hierarchy; this greatly improves self-diagnosis, yet 
has no perceptible impact on the performance of an optimised build. 

f. I tidied up the contents of the Testing directory by introducing the Binary subdirectory for KDF9 machine code 
programs, and by renaming Usercode as Assembly. This puts all the subdirectories together in a listing. 

g. I created a command, tsd, to simplify running the Time Sharing Director. 

h. I arranged for the tsd, nine, and whet commands to set the FWO file suitably for their own type of program run, 
restoring it on termination to its former contents. 

i. I tidied up IOC a little. 

j. I moved digital signature generation into kdf 9, where it properly belongs. 

k. I factored mode testing, and logging, out of the check_*_points procedures, gaining an 8% speedup in fast mode 
and no slowdown in other modes. 

l. 1 restricted the signature hashing to the two possibly-relevant Q stores, instead of all 16. This speeds up a run of 
ee9_self_test by a factor of 2.5! 

m. I added a facility to include Line Shift and Page Change characters in Flexowriter prompts, using the Latin-1 
characters ® and © respectively. 

n. I implemented the (EE model 1081) MT orders, with a (hopefully temporary) restriction that blocks are limited to a 
maximum of 512 KDF9 words in length. 

o. I corrected the timing of Flexowriter writes that include fillers and/or inject canned responses to prompts. 

p. I implemented OUTs 4 and 10, to let problem programs such as Whetstone Algol claim magnetic tapes as they would 
when running under Director. 

q. I made a version of the Whetstone Benchmark, called MTW, that outputs to a MT labelled WHETLIST, instead of OUT 
8 stream 30. 

r. I included four MT-handling programs in the self-testing procedure. They are RLT (Rewind and Label Tape); TRB 
(Test Read Backwards); 0UT4 (tests the new OUT); and OUTX (tests OUT 10). I also included MTW. 


V0.5,15-MAR-2011: First beta release 

a. I advanced the version number to 0.5; this is the first beta release, the change in status being justified by the lack of 
bug reports from heavy users. 

b. I fixed previously undetected bugs in ‘-DF’ and ‘x+±« ’. 

c. I provided a lax nest-depth checking option (option N), to better approximate the behaviour of the KDF9 hardware 
when the nest is under-filled. 

d. I fixed bugs in the nest-depth checking of some 1- syllable and 2-syllable orders. 

e. I improved the promptness of time-limit expiry in fast mode: it is now put off to the next successful jump, rather than 
to the end of the time slice. 

f. I improved the discrimination of the digital signature by hashing ICR into it. 

g. I speeded ee9 up by ~20% over V0.4: by judicious in-lining of store access primitives, by refactoring the instruction 
decoding, by removing some redundancy from several Q-store orders, and by implementing a better method of 
ensuring that Q0 is always 0; all this with no adverse effect on maintainability or modularity. 

h. I replaced the make command as a build tool with a shell command file called Build/mk9, which takes the same 
parameter options as the makefile formerly did. 

i. I added a section on building ee9 to the HOWTO file; and included URLs for EE Director documentation and the EE 
KDF9 Algol Manual. 

j. I made pop operations zeroize the affected nest cell(s), as the hardware did. 

k. I changed the V option flags to a more mnemonically consistent set: DHIJPS. 
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Yl.Ov, 21-Apr-2011: First public release 

a. I advanced the version number to 1.0: ee9 goes forth into the world! 

b. I fixed previously undetected bugs in ‘NEGD’ and ‘-D’. Thanks to the latter, and to David Holdsworth’s discovery of 
a mis-transcription in the Whetstone Controller's Usercode, Walgol numeric input now works properly. 

c. I completely revamped the tracing feature, replacing the jump and skip traces with a single, consolidated retrospective 
trace of all instructions executed while tracing is enabled. Each traced instruction is accompanied by its most relevant 
operand (see the User Guide for details). 

d. In conformity with (c), I changed the trace mode specifiers from JUMP_MODE and SKIP_MODE to RETRO_MODE; 
and the verbosity (option V) flags from D to S, and from J/S to R; again, with further improvement in mnemonic 
quality. 

e. I speeded ee9 up by ~10% over V0.5 by removing all tracing overhead from the fast mode code path. Tracing now 
invokes the fast mode code as a subroutine, wrapping it in calls that determine the operand to be traced. As well as 
being faster, this is more modular, since the details of tracing can now be changed without touching the fundamental 
emulation code. 


f. I wrote a program. Algol/input. a60 to test Algol numerical input; and included it in the self-testing procedure. 

g. I added a verbosity option to the command-line parameters of ee9 (see the Users’ Guide), whet, nine, dow, and 
tsd. This allows the tracing verbosity to be set without needing a V line to be put into a settings file. 

h. I changed the self-test procedure to use the new verbosity option, instead of setting up a V line in the settings files. 

i. I reverted change (e) of V0.5, as its adverse effect on performance became more onerous as a result of VI .0's 
increases in overall efficiency. 

j. I corrected the absence of a final OUT 0 or OUT 1 order from the tracing. 

k. I simplified the self-test logs by omitting the ‘last output line’ feature. 

l. 1 improved the layout of tracing output, reducing the screen-width needed to view it without wrapping lines. 

m. I removed the facility to monitor locations changed by peripheral input. 

n. I allowed for separate post-run dumps for a program and its overlay (e.g., the Whetstone Translator and Controller). 

o. I added a warning to ee9_self_test, re: overwriting of I/O device files. 

p. I rewrote the circular and double-length shift orders in conformity with EE engineering document K/GD.y.80, “KDF 
9: SHIFTING AND SHIFT CONTROL”. 


q. I rewrote KDF9 . as_Q ( ) and KDF9 . as_word ( ) as normal functions, avoiding a portability problem revealed by 
the MacOS X PPC Leopard port (with thanks to Mike Hore). 

r. I rewrote the way ee9 ensures that Q0 is never set to a non-zero value. In LAX_MODE an assignment to Q0 is now 
suppressed; in STRICT_MODE it is now treated as an execution error. 
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V1.5w, OI-Aug-2011: Second public release 

a. I advanced the version number from 1,0v to 1,5w, because adding support for Microsoft Windows seems like quite a 
big step. I am mindful that LISP never got past its version 1.5, but hope that there will be V2 of ee9! 

b. I corrected the instruction timings for =[R]{QCIM}q type orders; as a result the ee9 timing for the Whetstone 
benchmark is more accurate: 420.7s, down from 422.7s, the real KDF9’s measured time being about 417s. 

c. I added a test, in trace mode cycles only, to verify that Q0 = Q0/0/0 at the end of each instruction execution. 

d. I discovered that, with GNAT GPL 2011, optimised builds with all runtime checking suppressed run little (~6%) 
faster than with most checks enabled. Now the default ee9 build is optimised, with runtime checking. 

e. I added new verbosity flag options: A to suppress the output of messages when ee9 services an OUT API 
successfully; E to suppress the output of mere progress messages from ee9; F to suppress the output of the KDF9's 
Final state; and Z to suppress all output from ee9 itself, rather than KDF9. 

f. I amended the Flexowriter emulation package to use separate input and output file handles. This was necessitated by 
Microsoft Windows, but has been done in a way that is completely source-code compatible with UNIX systems. 

g. I provided alternative bodies for open_ui ( ) that opens the terminal user interface: one for Windows and another 
for UNIX systems. 

h. I amended 10. open ( ) to ensure that I/O transfers are transparent to all byte values. This is necessary on Windows 
to allow KDF9 binary machine code to be read uncorrupted, but has no effect on UNIX systems. 

i. I recast the mk9 shell command to better support builds of ee9 for Windows. 

j. I amended the shell files in Testing to eschew the use of file system links, which do not work well under Windows 
(to put it mildly). 

k. I amended the way ee9 ensures Q0 is never set to a non-zero value so that, in Director state, an assignment to Q0 is 
suppressed even in STRICT_MODE. 

l. 1 provided separate subroutines for Windows and for others, to isolate the change of font colour in Flexowriter FO. In 
this first version, the colour is not changed on Windows. 

m. I amended actual_prompt ( ) to cope with the presence and/or the absence of ANSI-terminal font colour escape 
sequences. 

n. I consolidated the Windows amendments for Flexowriter output into a single package, terminal. Alternative 
bodies for terminal are selected by the OS (second) parameter in a build call to mk9. 

o. I enhanced mk9 to take a parameter indicating whether a Windows or a non-Windows OS build is wanted. Several 
other options have been changed, in name and effect (see the HOWTO file, ‘Building Your Own Version of ee9’). 

p. I changed ee9_self_test, and its ancillary routines, to make them compatible with Windows/Cygwin. 

q. I updated all the documentation to take account of Windows deployment, and I added a new Appendix to the ee9 
Users’ Guide, giving various examples of the use of ucc, nine, whet and tsd. 

r. I converted all the documentation that was formerly in simple text files into PDFs, as the easiest way to circumvent 
the—eccentric—handling of plain data in Windows. 
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V1.9e, IO-Dec-2011: Third public release 

a. I advanced the version number from 1,5w to 1,9e, in view of the large number of improvements. 

b. I added a feature, authentic_time_mode, whereby the real elapsed time is made to approximate the elapsed time that 
would have been taken by a real KDF9 (by inserting timed pauses at suitable points during the run). 

c. I changed the N option designator to A, for ‘authenticity’, and added authentic_time_mode to its options. 

d. I reconceptualised ‘verbosity’ mode as ‘visibility’ mode, and added two new visibility flag options: D to request that 
optional debugging messages be output, and T to request that authentic_time_mode be set. 

e. I fully implemented the TSD’s device (de)allocation OUTs, using CPDAR properly to prevent access, in problem 
program mode, to unallocated devices. 

f. I improved the way the FW package deals with prompts, with a resulting simplification of the two OS_specif ics 
packages. 

g. I amended the FW package to support authentic timing of typewriter output. 

h. I provided implementations of the P| IO][ABCD ] and PM[ ADF ] orders for the fixed disc drive, based on information 
from David Holds worth, and on hypotheses developed by analysing PI 98 in the Eldon 2 Director and further by 
extrapolating from the Data Products 5022 disc drive manual and the I.C.T. 1956 disc drive flyer. 

i. I enhanced the 10 package to support fixed disc emulation and authentic timing of slow device output. 

j. I improved the traced operand value for instructions that update a Qk, as opposed to a Qq, operand. 

k. I tidied up the procedures that deal with LIVs. 

l. 1 rephrased the error message produced by a parity error, to make it clearer that it is probably only due to reading past 
the end of data. 

m. I added support for ‘character’ (in reality, one character per word) transfers to the TR. TP and FW devices, so that 
PIC, PID, POC and POD are now fully implemented by the two-shift devices. 

n. I corrected the timing of transfers on two-shift devices, allowing properly for shift characters, for filler characters, and 
for the fact that FW0 has separate input and output streams. 

o. I improved the realism with which short loops and short-loop jumps are timed, removing some ugliness in the 
process. The CPU time is now monotonically non-decreasing. 

p. I implemented POF for the TP, on the basis of the only reasonable hypothesis I can make of its action. 

q. I implemented all documented orders for the CR and CP devices. 

r. I added a card-code dumping format, code C; a lineprinter-code dumping format, code L; separate Case Normal and 
Case Shift formats, codes N and S; and a Latin-1/ASCII dumping format, code A, intended to facilitate the use of 
‘character’ transfers with Latin-1 data. 

s. I somewhat tidied the state_display package, which ‘just growed’. Ditto, the various IOC packages. 

1.1 changed the Qp terminology to Qk, for consistency with the Manual and KAL4. 

u. I radically reworked the instruction-fetch logic in order to remove a kluge in the implementation of the =EeQq 
instruction. (It was needed to prevent Director from overwriting the executing instructions in a JrCqNZS loop that 
zeroizes the whole of core.) Instead, I implemented a much closer approximation to the logic and the instruction 
buffer registers (IWB0 and IWB1) of Main Control. Partly in consequence, the virtual CPU time for the Whetstone 
Benchmark now much more closely approximates the actual measured time. 

v. I added a new test program mode of execution, which operates like problem program mode, but runs the code in 
Director state. This is not authentic, but is very useful for executing ‘hardware’ test programs. I added a nine_test 
command to the Testing directory, to make running in test program mode more convenient, and changed the 
ee9_self_test command to use nine_test in place of nine for the MT test programs. 

w. To better exploit the new device allocation feature (point e, above), tape reader 0 is detached from the binary 
program file after the (initial or overlay) program load, and re-attached to the TR0 text file. This makes it possible to 
run a program that has two separate paper tape input streams. 

x. I corrected various bugs in the SHAD and divide orders, revealed by David Holdsworth when running KAL4.1 took 
this opportunity to tidy up the code for shifts, multiplications, and divisions. 

y. I now set E7 of test-programs and problem-programs to a string, in the format DD/MM/YY, the date exactly 28 years 
ago; so that 1962 < 19YY < 2000, and 19YY has the same date/day-of-the-week mapping as this year. 

z. I corrected OUT 9 to deliver the time-of-day (instead of the elapsed time), and implemented OUT 17 to return both the 
CPU time and the ‘notional’ elapsed time. 

a. I corrected a bug in INTQq, which was limiting the hold-up to 1 virtual elapsed second in non-boot modes. 


5 

This document is licensed under a Creative Commons Attribution 3.0 License : http://creativecommons.Org/licenses/by-nc-sa/3.0/ 





For ee9 3.2, © 2018 William Findlay, last document revision: 2018-10-27 


6/10 


V2.0r, 30-Jun-2015: Beta release of V2 

a. I advanced the version number from 1,9e to 2.0r, to indicate the first release of a major new mark that includes graph 
plotting; updated the copyright date to 2015; and updated the acceptable system name parameters of mk9. 

b. I changed the way that OUTs are logged in the retrospective traces, to make OUT 8 more conspicuous and its 
parameters more perspicuous. Small integers (OUT numbers < 64) are logged in decimal; large integers (parameters > 
2 A 47) are logged in octal; and other values are logged in Q store format. 

c. I amended the behaviour of OUT 8 when addressing a Flexowriter, to conform more closely to the behaviour of the 
TSD as notified to me by David Holdsworth. Each message is now truncated to 8 words, if need be; embedded Line 
Shift and Horizontal Tab characters are disallowed; “; ” characters must be in bits 42-47 and must not be in the last 
word of the transfer; but anything after an End Message can safely be ignored. Failures are logged as error “730”, in 
the manner of the TSD. A correct message is always typed on a fresh line, a new line being taken if the typing position 
is not there already. 

d. I corrected some minor portability problems in the mk9 script and added support for the Raspberry Pi platform under 
Raspbian Linux. 

e. I added a new non-interactive mode, set with the new option N, to adapt ee9 to runs invoked by a command 
script. In this mode it is not possible to supply responses to prompts, whether from the KDF9 program or from ee9 
itself; so if an interactive input is requested in non-interactive mode, ee9 terminates with a suitable diagnostic 
message. Non-interactive mode can also be set with the command line miscellany parameter. 

f. I provided an implementation of the model 564 Calcomp graph plotter, as described in Appendix 6, §5, p.302 of the 
Manual. There was provision on the KDF9 to switch a buffer manually between a tape punch and a graph plotter; in 
ee9 this is done with a new settings file option, G. If G is given, GP0 replaces TP1. This can also be done with a 
miscellany parameter including g on the ee9 command line. 

The drawing is output to the GP0 file in the form of Encapsulated PostScript. I expect any competent modern OS to 
have a utility that will open such a file and display the plot on screen. 

g. It was possible to fit pens with a variety of ink colours and bail-point tip sizes to the plotter. To simulate this, option 
G can set the pen colour from the list: Black (the default). Blue, Brown, Cyan, Dark_Blue, Dark_Cyan, 
Dark_Green, Dark_Grey, Dark_Magenta, Dark_Red, Green, Grey, Magenta, Red, White, and 
Yellow; and, additionally, can set the pen tip size from the list: Extra_Extra_Fine (the default, one plotting 
step wide), Extra_Fine. Fine, Medium, Medium_Broad, Broad, Extra_Broad. 

h. I implemented OUT 5 for GP0, taking the device type code to be #20, as stated in “Order Code Notes 18-Further 
OUTs” and consequently changed the output format of device type codes from decimal to octal. 

i. The Usercode program GPT. k3 in the Assembly directory runs a test on the plotter. The Usercode program 
TR2GP. k3 in the Assembly directory copies a file of plotting commands from a tape reader to the plotter. 

j. I added a new mode, D, to pseudo-Usercode core printing, such that operand and jump target word addresses are 
shown in decimal instead of octal, for ease of use with other software that works with addresses in this format. 

k. I provided decimal interpretations of the internal registers, SJNS and Q store in the final state display, for use with the 
previous facility. 

l. 1 added a decimal Q store interpretation of whole words in the NEST and core prints, and some whitespace to make 
for easier reading of their listings. 

m. I modified the syntax of options with address parameters in the settings files to allow both octal and decimal 
addresses to be specified, octal addresses beginning with “#’, as before. 

n. I removed the largely ineffectual checking of the miscellany parameter from nine, nine_test, tsd and whet; 
the checking is now done by ee9 itself. 

o. I made a number of other minor improvements, e.g. to logging and error messages; and renamed the external tracing 
file as trace. txt instead of f ull_trace. txt. 

p. I implemented the PHU store. 

q. I modified the command line syntax for better mnemonic significance. 

r. I refactored FD support packages to avoid a cyclical dependency. 

s. I added a clearer interpretation of the parameter of an FD order in instruction traces. 

1.1 implemented CRLF line terminators for text-file output under MS Windows. 
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V2.1Y, 28-FEB-2017: FOURTH PUBLIC release 

a. I advanced the version number from 2.Or to 2.1 y, and the copyright date to 2017. 

b. I enhanced the source to exploit features of Ada 2012, principally by converting Assert pragmas to pre- and post¬ 
condition aspects, and by using conditional expressions and case expressions wherever beneficial. 

c. I corrected a minor programming error in kal3 that evoked annoying warning messages from the C compiler. 

d. I corrected the FW typed character count, which had been wrongly omitting the output of LS characters because of an 
inconsistency in the use of put_EOL. 

e. I eliminated irrelevant registers from the information output during (pause mode) single-stepping, and changed the 
name used for the top cell of the SJNS from SI to JB (Jump Buffer), as it was called by EE. 

f. I improved the User Guide by moving lengthy examples to Appendices and adding more explanatory context. 

g. I enabled pre-run core printing for the Whetstone controller, overlaid on the Translator by OUT 1. 

h. I corrected errors in both the documentation and the implementation of the V miscellany setting, and allowed for a 
command-line time limit. 

i. I improved the handling of premature EOF/absent file errors when loading or booting. 

j. I made the 10 package a child of KDF9. 

k. I improved KDF9 elapsed-time handling to prevent a possible overflow. This was extremely unlikely to happen on 
the actual hardware, which would have to had run for over 3 months without a break, but is much more likely in 
emulation, as 3 KDF9 months pass in as little as 9 hours real time! 

l. 1 added support for time zones / daylight saving to the implementation of the time-of-day clock. 

m. I corrected the machine codes for the PMGQq and PMHQq orders, following the discovery of a source text of the 
native Usercode compiler. 

n. In response to the information that the Eldon KDF9s allowed the CTQq instruction in problem program state, I added 
this feature to execution in lax mode in anticipation of running Eldon some day; and I corrected the requirement for 
MANUALQq to be executed in Director state. 

o. I added a Q command to option files. It causes ee9 to quit after loading the KDF9 program and before executing it. 
With a pre-run dump command in the same option file, this provides a convenient way to get a disassembly of the 
program without running it. 

p. I added an X command to option files. It causes ee9 to run in external trace mode, but giving the signature hash, [Nl] 
where applicable, and the dis-assembled instruction. 

q. I added q and x options to the miscellany parameter, with the same effect as the Q and X settings-file flags. 

r. Following discoveries by David Holdsworth about the Kalgol compiler’s use of the FRB instruction, its emulation has 
been modified to deliver a compatible result, despite that being at variance with restrictions stated in the Manual and 
in EE document K/GD.y.80, “KDF 9: SHIFTING AND SHIFT CONTROL”. 

s. I simplified and thereby corrected the tracing of an OUT 8. 

1.1 corrected the documentation with regard to the usage of TR0 and TR1. 

u. I extended the effect of the output suppression parameter to OUT 1 overlaying and to the macros tsd, whet, nine 
and nine_test; including suppression of the output file listings with the z option. 

v. Following a bug discovered by Bill Waite, I corrected the handling of the end-of-file condition on TR and CR input, 
when the transfer was not to End Message but the last word was incomplete due to inadequate data. 

w. To make it as simple to run programs with CR input as with TR input, I added the command crnine (like nine) 
and a subcommand crud (like lud) and added a CR/CP test to ee9_self_test. 

x. I removed all restrictions on overlaying (by means of OUT 1) programs other than the Whetstone Controller, and 
allowed for programs composed of multiple C-blocks. 

y. Following problems experienced by Bill Waite, I changed the terminator for character-mode transfers to End 
Message, from a character with code 75 8 (“=” in Latin-1) to “I”, which is the same as for fixed-length transfers and 
much more useful in practice. 

z. Following problems experienced by Roberto Sancho Villa, I rewrote the RLT program to take a less fragile data 
format, and amended its data file accordingly. There were consequential changes in the 0UT4, OUTX and TRB 
programs, and thence to the self-test. I also improved the somewhat misleading error message, particularly in Director 
mode, that was given when an attempt is made to operate an absent I/O device. 

A. I restored the FD test programs TFD, TFDEM and TFDFH to working order and added TFDOR to test the area overrun 
(trying to read/write past the end of a seek area) logic. 

B. I corrected a long-latent bug in the checking and reporting of an invalid I/O transfer store address. 

C. I corrected the calculation of disc rotational latency, and added a Q store printing format for non-seek orders. 

D. I changed the logic of LI Vs so that test mode is treated the same way as program mode, avoiding misleading 
“Director failure” error messages from misbehaving test programs. 

V2.1Z, 08-FEB-2018: Ada 2012 CORRECTED VERSION OF V2.1y 

a. I advanced the version number from 2.1y to 2.1z, and the copyright date to 2018. 

b. I corrected the error in JrV/JrNV that failed to clear the V bit. 
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V3.1,16-JUL-2018: Fifth public release 

a. I advanced the version number from 2.1y to 3.1a; and made ee9 announce its genesis in its opening message. 

b. I significantly refactored the GP/plotter/postscript subsystem to enforce normal coupling between the packages; some 
former kinds of erroneous behaviour are no longer possible. 

c. I continued the effort to use Ada 2012 to simplify the code, in particular exploiting the name ' Image feature. 

d. I improved the error handling in host_IO. 

e. I shuffled the buffer numbers around so that the block devices are all in the 8.. 15 range; and included DR0 in the 
configuration for the first time, on buffer 15. 

f. I removed a latent bug in the checking of buffer numbers for the TSD MT OUTs. 

g. I corrected the I/O trace logging of TSD OUTs 6 and 7. 

h. I completely rewrote the MT subsystem, removing all practical limits on the size of erased tape gaps, and increasing 
the limit on the largest block to more (4096 words) than the maximum recommended in the Manual (3000 words). 
Data blocks and erased tape are represented by one or more short ‘slices’ of data or erasure. This is more efficient for 
OUT 8 tapes than the previous implementation. The emulation of tape operation times is now much more realistic. 

i. I implemented the DR0 device, making many assumptions as to its undocumented characteristics, but assisted by the 
annotated copy of a drum-capable Director from David Leigh. Iadded the test program TDRUM; and made the end- 
of-run statistics reporting for FD0 consistent with DR0. 

j. I introduced new exceptions—operator_error, operand_error, Director_f ailure and 
Director_operand_error—to replace inauthentic LIV reports with more accurate error messages. 

k. I added a new O option to enable the output of the current m/c state prior to an OUT 1 overlay. 

l. 1 refactored IOC.FD along the same lines as IOC .DR, removing potential cyclical dependencies; and implemented a 
better stab at the working of the fixed-head disc orders, adding several new test programs TD1SK*. 

m. I made the elapsed time of the FD PMD order more realistic. 

n. I made the buffer-status testing order PAR take its MC time; this ensures that it appears correctly positioned in the 
elapsed timeline. 

o. I implemented the FD ‘next sector’ orders: PIE, PIF, PIG, PIH, POG, POH, POK, and POL. Their traces include the 
sector number actually used in the transfer. 

p. TR0 and TP0 are no longer represented by the standard input and output; instead they bind to device files in the same 
way as other devices. 

q. I made it possible to choose between Latin-1 and KDF9 code for two-shift devices, on a per-device basis, with new 
ee9 parameters -TR and -TP; furthermore, a program file to be loaded or booted is now specified with a parameter of 
the form +program_name , and not supplied as standard input. Paper tape input in KDF9 code is checked for validity, 
and a new exception— invalid_paper_tape_f ile—is raised when a problem is found. 

r. I updated the *nine* and whet-related command files to support the new command-line syntax of ee9. 

s. I improved program loading from paper tape, allowing loading up to the 32K limit, and checking the data for 
consistency and feasibility; the exception invalid_paper_tape_f ile is raised on premature EOF. 

1.1 changed the code for booting and loading to expect program files in authentic KDF9 paper tape code. I wrote a 
program (see the following point) that converts raw bytes to paper tape code, and incorporated it into the ucc 
command, so that the user need not see the raw byte files. For this reason I also removed the . kdf 9 filename 
extensions from programs generated by ucc, as well as those originally in the Binary directory. This makes the names 
of WAlgol, KAlgol, Director and OUT 1 overlay files consistent with program files in general, and is a step towards 
being able to load problem programs under Director. 

u. For convenience in dealing with KDF9 code files I wrote two simple utility programs. These are: 

a_block: output a program call tape, or ‘Ablock’, in KDF9 code; take the ‘program reference number’ and ‘title’ 

from successive lines of standard input, and write the result to standard output. 

a2b: read from standard input in a stated code and write it to standard output in another code. Conversions are 
implemented from raw bytes to paper tape code; from paper tape code to octal words in half/word, Q store and 
syllable formats; and between paper tape code and Latin-1. 

v. Following a more careful reading of §8.4 of the manual, assigning to Q0 is now always simply overridden, either by 
setting it back to 0, or by not changing it from its 0 value in the first place. 

w. Following information from David Holdsworth, I corrected a bug in the JrV order, to make it clear VR. 

x. I added the OUT 8 ‘gap’ feature, previously missing. 

y. I wrote a command, tsdnine. to simplify running problem programs under the Time Sharing Director. The rlt 
shell procedure is first run by tsdnine with its usual data files, to ensure that the MT? files are set up for Director 
use. tsdnine then takes its first parameter to be the name of a Usercode program in the Assembly directory, 
assembles it using ucc, creates an A block for it using a_block, concatenates this with the output from ucc, and 
any data file, and writes the result to TR1. It then invokes Director using the tsd command. Once Director has 
booted, a FLEX interrupt ( A C) makes it load and run the program from TR1 (the Director load command has been 
added to FW0_f or_Director). 

z. The retro-trace of I/O operations now logs the instruction in the device-specific form given in the Manual, if such is 
defined; e.g. PIFQ1 for a magnetic tape is listed as MBREQ1. 

A. I refactored the package OS_specif ics so that it no longer depends on any other ee9 package. This results 
in a cleaner interface, and allows it to be used by the a_block and a2b programs without dragging in most of ee9 
via unwanted transitive dependencies. There is a trivial consequent change to ioc-two_shift-fw. adb. 

B. I corrected an error in ioc-slow. shift. get_symbols that generated unnecessary case shifting for characters 
that are available in both shift- and normal-case character sets. 
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C. I implemented a means to ‘poke’ amendments into binary programs after loading and before the start of execution. 
This required the ‘postmortem’ P setting to be renamed F, and the removal of the (almost never used) fetchpoint-only 
setting. Fetchpoints can still be set in combination with storepoints, using the watchpoint setting. 

D. I updated the historical paper ‘ The Hardware of the KDF9’. 

E. I put in some simple infrastructure for debugging runs: the tracing option d sets the Boolean variable 
debugging_is_enabled, which can be tested at run time to make output conditional. Enclosing a call of a 
procedure in pragma Debug (...) ensures that its code is included in the build of ee9 only by a ‘warning’ 
compilation; in a normal compilation it is completely suppressed and incurs no space or time overhead. The new 
tracing .message procedure displays its string parameter iff debugging_is_enabled, and its body is 
included in the object program subject to pragma Debug (...). 

F. I refactored the IOC package and its descendants, and revised the I/O device type hierarchy to be more reflective of 
the similarities between the actual devices, thus; 

IOC . device (abstract—objects cannot be declared) 

IOC . fast. device (abstract—objects cannot be declared) 

IOC.fast.DR.device 
IOC.fast.FD.device 

IOC . fast .magtape. device (abstract—objects cannot be declared) 

IOC.fast.magtape.MT.deck 
IOC.fast.magtape.ST.deck 
IOC . slow, device (abstract—objects cannot be declared) 

IOC . slow, shift. device (abstract—objects cannot be declared) 

IOC.slow.shift.FW.device 
IOC.slow.shift.GP.device 
IOC.slow.shift.TP.device 
IOC.slow.shift.TR.device 
IOC . slow, unit. device (abstract—objects cannot be declared) 

IOC.slow.unit.CP.device 
IOC.slow.unit.CR.device 
IOC.slow.unit.LP.device 

G. I factored the KDF9 symbol type and character codes out of KDF9 into their own package, KDF9_char_sets, so 
that they could be accessed by a_block and a2b without dragging in the rest of KDF9. 

H. I removed all Unsuppress pragmas from the source files and put them into the compilation configuration files. 
This means that packages formerly compiled with suppressed checks now compile with them enabled. This has made 
no perceptible difference to the performance of ee9. 

I. 1 corrected a long-standing error in the KDF9 . CPU. reconstruct operation, which was yielding an incorrect 
double-length floating-point result when given a fixed-point fraction with an all-zero more-significant word. 

J. I changed the interpretation of the graph plotter’s command codes, in accordance with evidence found in manuals for 
contemporary computers that employed the same device. 

K. I amended the DIVR and DIVD microcode to correct an error in calculating quotients (and hence remainders) due to 
assuming that the Ada fractional division operation truncates, when in fact it rounds; and improved the handling of 
overflows and of invalid dividends having DO of the less significant word non-zero. The latter is almost certainly not 
authentic, but is better than nothing. 

L. I removed some unused presentational floating-point functions from KDF9 . CPU. 

M. I allowed more OUT 8 stream numbers, and shared the #10-17 range between TP0 and TP1. 

N. I updated the Guide and added Appendices describing the TSD OUTs. I detailed therein the ways in which the 
authentic OUT 8 operations differ from the approximations made by ee9. 

O. Since the ucc command now produces object programs in KDF9 character code, which is not acceptable to David 
Holdsworth’s kdf9 emulator, I provide the command uc2kdf9 to produce a program in the form needed by kdf9. 

P. I corrected an error in the way some invalid operations were treated in test program mode and in Director state. They 
were ignored, which could cause a later failure in a routine that relied on invalid operations forcing termination to 
ensure a precondition. Now all invalid operations force termination. 

Q. I added a DIVR test to the self-test. 

R. I added Appendix 8 to the Users Guide, listing and categorising all terminating error conditions. 
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V3.2, dd-mmm-2018: Sixth public release 

a. I advanced the version number from 3.1a to 3.2a. 

b. I enhanced the a2b utility, to simplify the options flags; and changed the -p2o flag to output a line/word number and 
the character interpretation of each word. 

c. I modified the a_block utility, to generate a call tape for a program on a specified medium rather than only a TR, 
and renamed it call_tape, which is more historically accurate. 

d. I moved the character-mapping function glyph_f or from state_display to KDF9_char_sets, for better 
modularity and for reuse (e.g. in a2b). 

e. I changed the string-length field in a MT slice from 2 bytes to 1 bytes, thus avoiding endian-ness issues and making 
MT files more portable. 

f. I added Appendix 9 to the Users Guide , listing the TSD TINTs and other console operating information, and added 
the POSIX exception messages to Appendix 8. 

g. I implemented an instruction-word execution frequency profile with histogram output, and added the H option to 
control it, and the previously existing instruction type histogram. 

h. When disassembling, if the operand of a SET instruction needs more than 1 digit of the selected base, its octal 
representation is supplemented by its decimal representation in a comment; or vice versa. 

i. I added a LIV when the EXIT instruction has an effective word address > 8190, in accordance with the EE 
engineering document K/GD.y.82, “INTERRUPTION AND FETCH NEXT INSTRUCTION SEQUENCES OF 
KDF9 MAIN CONTROL”, §4.0(b)(iii). 

j. I reverted the change allowing CTQq in problem program state with LAX mode, following better information from 
David Holdsworth about how the Eldon 2 Director actually worked. 

k. I made ee9 more tolerant of absent device files: if an output or input/output file is missing, ee9 now creates it 
without reporting an error. 

TO DO: 

Think about what is needed to run Kidsgrove Algol, and/or a native Usercode compiler. 

Get programs running reliably under Director. 

Implement TSD FD OUTs. 

Implement TSD DR OUTs. 


TO 
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